home *** CD-ROM | disk | FTP | other *** search
/ Ultimedia 1 / Ultimedia 1.iso / tools / grafiktools / showvic / showvic.doc < prev    next >
Text File  |  1993-07-03  |  10KB  |  279 lines
  1.  
  2.                                ShowVIC V3.01
  3.                                =============
  4.  
  5.                           Created by Matt Francis
  6.                  ReqTools and PowerPacker by Nico François
  7.  
  8.                  Comments, suggestions, bug reports etc. to
  9.                         m.p.francis@newcastle.ac.uk
  10.  
  11.  
  12. DISCLAIMER
  13. ----------
  14.  
  15. This program comes with no warranty, either expressed or implied.  The
  16. author is in no way responsible for any damage or loss that may occur due to
  17. direct or indirect usage of this software.  Use this software entirely at
  18. your own risk.  Having said that, I'm a good programmer and I've tested
  19. ShowVIC thoroughly, so I shouldn't think there will be any problems.
  20.  
  21.  
  22. COPYRIGHT
  23. ---------
  24.  
  25. This software is freely distributable, BUT the ShowVIC program, the
  26. ConvertFox program and all documentation are copyright 1993 Matt Francis.
  27. The ReqTools and PowerPacker libraries are copyright to Nico François.  The
  28. sample pictures included are copyright to other parties, and are provided
  29. simply to demonstrate the program.  Permission is NOT given to re-release
  30. the ShowVIC program and/or documentation if it has been altered in any way.
  31.  
  32.  
  33. DISTRIBUTION
  34. ------------
  35.  
  36. Permission is given to include the ShowVIC package in a public archive (such
  37. as a BBS, FTP site or PD library) providing that all parts of the original
  38. distribution are kept intact.  These are as follows:
  39.  
  40.     ShowVIC/ShowVIC
  41.     ShowVIC/ShowVIC.info
  42.     ShowVIC/ShowVIC.doc
  43.     ShowVIC/ShowVIC.doc.info
  44.     ShowVIC/ConvertFox
  45.     ShowVIC/ConvertFox.doc
  46.     ShowVIC/ConvertFox.doc.info
  47.     ShowVIC/Formats.doc
  48.     ShowVIC/Formats.doc.info
  49.     ShowVIC/Libs/reqtools.library
  50.     ShowVIC/Libs/powerpacker.library
  51.     ShowVIC/Pictures/#?
  52.  
  53. No charge may be made for the ShowVIC package, other than a *reasonable*
  54. copying fee, and/or the price of the media.
  55.  
  56.  
  57. REQUIRMENTS
  58. -----------
  59.  
  60. Required:    Kickstart V37 or above
  61.         ReqTools library V38 or above (supplied)
  62.  
  63. Recommended:    PowerPacker library V35 or above (supplied)
  64.         PowerPacker (commercial) or PowerPacker mini-clone (PD)
  65.  
  66.  
  67. INTRODUCTION
  68. ------------
  69.  
  70. Welcome to a major new version!  ShowVIC converts and displays Commodore 64
  71. hires and multicolour bitmaps.  A number of different formats are supported,
  72. which ShowVIC automatically identifies and converts.  These are as follows:
  73.  
  74.  - Koala
  75.  - Artist 64
  76.  - Art Studio
  77.  - Advanced Art Studio
  78.  - Image System (multicolour and hires)
  79.  - Blazing Paddles
  80.  - Vidcom 64 (currently multicolour only - see note at end)
  81.  - Doodle
  82.  - FLI
  83.  - PageFox (indirectly)
  84.  
  85. PageFox pictures (160x200/320x200 only) can be converted to Koala or Art
  86. Studio formats (as appropriate) with the enclosed ConvertFox program.
  87.  
  88. If you have PowerPacker (or the PowerPacker mini-clone) you can crunch all
  89. your pictures.  If not, don't worry as you will still be able to view
  90. crunched pictures (providing you install the PowerPacker library).  ShowVIC
  91. was written in assembly language, making it small and fast (especially the
  92. picture conversion).
  93.  
  94. ShowVIC has been tested on several configurations, ranging from a basic
  95. A500+ running Kickstart V2.04 to a super-duper A1200 with the fabulous
  96. Kickstart V3.0.  It is totally OS compliant, as all Amiga programs should be
  97. (discounting demos and action games :-).  It works without problems for me,
  98. and I hope it works as well for you.
  99.  
  100.  
  101. USING SHOWVIC
  102. -------------
  103.  
  104. ShowVIC can be started from a Shell or from the Workbench.
  105.  
  106. ShowVIC's screen has two menus, each covered in turn below.  ShowVIC uses
  107. Intuition's new menu-help feature, so pressing the help key while a
  108. particular menu item is highlighted will cause an information requester to
  109. appear describing the item's function.
  110.  
  111. Project:    Open        - Loads  a  C64 picture.  The format will be
  112.                   automatically determined (or else an error
  113.                   requester will appear).
  114.  
  115.         Save As        - Saves  the  current  image as a compressed
  116.                   IFF   ILBM  file.   The  picture  will  be
  117.                   320x200  with  16  colours.   The  current
  118.                   palette is saved with the picture.
  119.  
  120.         About        - Opens  a requester displaying, among other
  121.                   things, the format of the current picture.
  122.  
  123.         Quit        - Exits ShowVIC.
  124.  
  125.  
  126. Settings:    Edit Palette    - Allows  you  to  change the screen colours
  127.                   using the ReqTools palette requester.
  128.  
  129.         Restore Palette    - If   you  make  a  complete  mess  of  the
  130.                   palette, you can restore the proper values
  131.                   with this option.
  132.  
  133.         Title Bar?    - Toggles the title bar (hidden by default).
  134.  
  135.         Save Settings    - Saves the current palette and the state of
  136.                   the  title  bar.   These  settings will be
  137.                   restored  when you next use ShowVIC.  (The
  138.                   settings  are  saved  as  a standard prefs
  139.                   file   in   ENV:    and   ENVARC:   called
  140.                   "ShowVIC.prefs").
  141.  
  142.  
  143. Finally, sending ShowVIC a CTRL-D will pop its screen to the front, ready
  144. for use.  If ShowVIC receives a CTRL-C, it will quit as if you had selected
  145. the "Quit" option in the "Project" menu.
  146.  
  147.  
  148. CONVERTING PICTURES
  149. -------------------
  150.  
  151. Porting pictures from the C64 to the Amiga can be done by using a C64
  152. emulator or transfer program (for example TransNib, my generic parallel
  153. transfer protocol).  Picture files should retain their load address bytes
  154. (the first two bytes of the file) and should be exactly the right length
  155. otherwise ShowVIC will reject them (the correct lengths, and other
  156. information, are given in "Formats.doc").  This won't usually be a problem,
  157. especially if you rip pictures with Action Replay or something similar.
  158. (BTW:  Action Replay VI doesn't seem to save the proper screen colour in
  159. Image System files, nor does it pad the filename properly).
  160.  
  161. Once you've ported a load of pictures, the best thing to do is to crunch
  162. them all with PowerPacker (assuming you own the program - if not, get hold
  163. of the PD PowerPacker mini-clone).
  164.  
  165. To make pictures look more like they would on a C64, make your monitor's
  166. screen a bit narrower (if it'll let you), and stand back a bit.  For
  167. authentic results, view ShowVIC pictures on a crap television or through a
  168. sheet of slightly frosted glass for that fuzzy "composite video" look.  For
  169. maximum nostalgia-factor, use ShowVIC in conjunction with PlaySID for the
  170. ultimate C64 experience!
  171.  
  172.  
  173. SPECIAL NOTES ON VIDCOM
  174. -----------------------
  175.  
  176. Unfortunately, Vidcom doesn't seem to store the screen colour in its bitmap
  177. files.  To get round this, ShowVIC takes the screen colour from byte 2026
  178. ($7EA), which is usually a zero (this offset takes into account the two
  179. load-address bytes).  This can be changed by loading the picture into a
  180. binary file editor like NewZap or DekSid, and changing byte 2026 to a value
  181. from 0 to 15.  Vidcom, by default, uses a dark blue screen (colour 6) but as
  182. byte 2026 is usually zero, Vidcom pictures will by default have a black
  183. screen colour.  Of course the best way round this is to avoid using the
  184. Vidcom format - I recommend you use a format such as Advanced Art Studio or
  185. Koala (the Advanced Art Studio format is the smallest).
  186.  
  187. One more thing about Vidcom is that it seems to use the same format for both
  188. hires and multicolour pictures, making it impossible to distinguish between
  189. them.  For this reason, ShowVIC currently converts all Vidcom pictures as
  190. multicolour bitmaps.  If many people badger me (unlikely), I might add a
  191. switch in a later release, so you can choose which mode to convert to.
  192.  
  193.  
  194. CLOSING WORDS
  195. -------------
  196.  
  197. Things to anticipate in future versions:
  198.  
  199.  - An AppIcon to drop picture files onto,
  200.  - An ARexx port (to make slideshows, do batch conversion, synchronise with
  201.    PlaySID etc.)
  202.  - Support for more formats (Paint Magic, Amica, Page Fox (extended size),
  203.    Mouse and Cheese etc.  Some of these formats support large pages sizes,
  204.    which ShowVIC will support by using a virtual screen.)
  205.  - An option to convert Vidcom pictures as hires instead of multicolour,
  206.  - Sprite slideshow (just kidding).
  207.  
  208.  
  209. ACKNOWLEDGMENTS
  210. ---------------
  211.  
  212. My thanks go out to the following people (in no particular order):
  213.  
  214.     PT and GD for supplying me with C64 games to rip pictures from.
  215.  
  216.     Pasi 'Albert' Ojala for information on the FLI format (and for his
  217.     interesting articles in C= Hacking).
  218.  
  219.     Georg Schwarz for sending me loads of nice Koala pictures.
  220.  
  221.     All the great comp.sys.cbm people who expressed interest in ShowVIC
  222.     (hope you like it now that it's finally released!).
  223.  
  224.     Ron and Håken for PlaySID V2.1 (should've been a Commodity though :-)
  225.  
  226.     All the other people who are keeping the C64 alive after all this time.
  227.  
  228.     Nico François for the PowerPacker and ReqTools libraries, which make
  229.     life much more pleasant.
  230.  
  231.     Jan van den Baard for GadToolsBox, which was used to design the
  232.     Intuition bits for ShowVIC.
  233.  
  234.     Matt Dillon for producing an astonishing array of unique and
  235.     professional software (if you program the C64 and have an Amiga, check
  236.     out DAsm, his brilliant 6502 cross-assembler).
  237.  
  238.     CygnusSoft for CygnusEd, the fastest, most stable and BEST text editor
  239.     for the Amiga (and, from what I've seen, for any computer!).  And it
  240.     still works without problems on my A1200!
  241.  
  242.     Commodore for brilliant computers which the competition just can't
  243.     match.
  244.  
  245.  
  246. HISTORY
  247. -------
  248.  
  249. V3.01 -    Added on-line menu help.  Made title bar shown by default.  Other
  250.     minor changes.  ByteRun1 compression added to IFF save routine.
  251.  
  252. V3.00 -    Almost totally re-written.  Added menus, palette requester, IFF save
  253.     and support for Doodle and FLI formats.  Picture decoding is
  254.     slightly faster too.
  255.  
  256. V2.23 -    Tweaked a couple of things.
  257.  
  258. V2.22 -    Dependance on PowerPacker library removed.  Added Kickstart version
  259.     check.
  260.  
  261. V2.21 -    Minor addition made to Workbench side of things.
  262.  
  263. V2.20 -    File requester mode added for both Shell and Workbench invokation.
  264.     Minor cosmetic surgery performed on code.
  265.  
  266. V2.15 -    Another minor re-write to incorporate ReqTools.  Error reporting
  267.     from Workbench improved greatly.  Rearranged a few things.
  268.  
  269. V2.10 -    Minor re-write to incorporate Workbench support.  Multicolour
  270.     conversion routines optimised slightly.
  271.  
  272. V2.01 -    Added multiple files option.
  273.  
  274. V2.00 -    Re-written for Kickstart 2.
  275.  
  276. V1.1  -    Added support for hires bitmaps, pointer glitch corrected.
  277.  
  278. V1.0  -    First release.
  279.